BlueCielo Meridian Enterprise 2016 Configuration Guide

Configuring custom icons

Meridian Enterprise includes icons for all of the objects that it shows graphically, including folders and documents. Instead of these icons, you can configure custom icons.

You might want to configure custom icons for:

• Different folder types
• Documents in standard formats and that appear with the generic Windows file icon
• Showing the same icon for a document type regardless of the icon shown by different versions of the same program
• Programmatically changing icons based on user actions, document status, workflow states, or property values

Meridian Enterprise shows icons in numerous places in the system:

• Navigation views
• Folder and document property pages
• Application Integration
• Show Revisions dialog box
• Find and Key Find dialog boxes
• Show Project Copy dialog box
• Briefcase dialog boxes
• Reference Explorer

Note    Custom icons are not supported by hybrid document parts.

To configure custom icons:

1. In your favorite image editing program, create the following files depending on whether you want custom icons for documents, for folders, or for both:

• CustomDocumentImagesSmall.bmp (16x16 pixels)
• CustomDocumentImagesLarge.bmp (32x32 pixels)
• CustomFolderImagesSmall.bmp (16x16 pixels)
• CustomFolderImagesLarge.bmp (32x32 pixels)

You must create both a small icon file and a large icon file for each object type, documents or folders.

Each image file must be an image list bitmap that contains all of the icons of each object and icon size. For example, CustomFolderImagesSmall.bmp must contain all custom small icons for folders. The folder image lists should contain pairs of icons that show the same icon as both closed and open similar to the following figure (not all open state icons drawn for simplicity).

For more information about image lists, see About Image Lists on the MSDN website.

2. Place the image list files in the folder C:\Program Files (x86)\Common Files\Cyco Shared (64-bit computers) or C:\Program Files\Common Files\Cyco Shared (32-bit computers) of each client computer.

   Alternatively, you can place the files in a different location and specify the path to the files in the following (String) registry settings:

   On 32-bit computers:

   HKEY_LOCAL_MACHINE_\SOFTWARE\Cyco\AutoManager Meridian\CurrentVersion\CustomDocumentImagesLarge
   HKEY_LOCAL_MACHINE_\SOFTWARE\Cyco\AutoManager Meridian\CurrentVersion\CustomDocumentImagesSmall
   HKEY_LOCAL_MACHINE_\SOFTWARE\Cyco\AutoManager Meridian\CurrentVersion\CustomFolderImagesLarge
   HKEY_LOCAL_MACHINE_\SOFTWARE\Cyco\AutoManager Meridian\CurrentVersion\CustomFolderImagesSmall

   On 64-bit computers running 32-bit software:

   HKEY_LOCAL_MACHINE_\SOFTWARE\Wow6432Node\Cyco\AutoManager Meridian\CurrentVersion\CustomDocumentImagesLarge
   HKEY_LOCAL_MACHINE_\SOFTWARE\Wow6432Node\Cyco\AutoManager Meridian\CurrentVersion\CustomDocumentImagesSmall
   HKEY_LOCAL_MACHINE_\SOFTWARE\Wow6432Node\Cyco\AutoManager Meridian\CurrentVersion\CustomFolderImagesLarge
   HKEY_LOCAL_MACHINE_\SOFTWARE\Wow6432Node\Cyco\AutoManager Meridian\CurrentVersion\CustomFolderImagesSmall

   Or you can set the path to the location in the %CYCOSHARED% environment variable.

3. If you want the custom icons to appear in Web Access , create a separate set of icon files in the IMG folder on the Web Access server. By default, it is located at C:\inetpub\AMM\Img.

   The icon images should be 16x16 pixels in size and each contain one icon. The files must be saved in the GIF format.

   You must create two files for each custom folder icon, one file showing a closed folder and a second file showing an open folder. The names of the files must conform to the following syntax where <ImageListIndex> is the index (one-based) of the corresponding icon in the image lists created in step 1 and where <ImageState> is the letter o for the open icon and the letter c for the closed icon: nav_icon_<ImageListIndex+38>_<ImageState>.gif . For example, the Web Access equivalents of the first (image list index 1) custom folder icon created in step 1 would be nav_icon_39_o.gif (1+38, open) and nav_icon_39_c.gif (1+38, closed).

   You must create one file for each custom document icon. The names of the files must conform to the following syntax where <ImageListIndex> is the index (zero-based) of the corresponding icon in the image lists created in step 1: ci_<ImageListIndex>.gif. For example, the Web Access equivalent of the first custom document icon (image list index 0) created in step 1 would be ci_0.gif.

4. Select the custom icons in Configurator for the folder types and folder levels that you want to use the icons as described in the following topics. Your custom icons will appear in the icon lists after the built-in icons.

   • Creating the initial Field-Path definition
   • Creating and editing folder types
   • Configuring the levels of a view
5. Create custom script to set the AMFSObjectPropertySet._ICONINDEX property of documents to the index number (zero-based) of the corresponding icons in the image lists. For more information about working with script, see the BlueCielo Meridian Enterprise VBScript API Reference.

To manually set the custom icons for individual documents:

2. In PowerUser, select a file for which you want to set a custom icon.
3. View its Advanced Document Information dialog box as described in the BlueCielo Meridian Enterprise User's Guide.
4. In the File/Folder property set, double-click the Icon Index row. The Change Icon Index dialog box appears.
5. Click the custom icon in the Select icon list. Click Reset to select the default icon.
6. Click OK to save your changes.